


Microcontroller Dice 


using the 8988252 Flash Board 


Design by b. Kainka 


Writing a microcontroller program and implementing it in real hardware 
simply requires a development system. The Elektor Electronics 8988252 
Flash board is just the ticket, even if you intend to write code for a target 
system based on a ‘lesser’ controller like the AT89C205 1. 


89C2051 


3...12MHz 021001 - 11 


Figure |. Circuit diagram and connections of the dice circuit to the 89S8252 Flash board. 
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In this article, our assignment will 
be to design electronic dice based on 
a microcontroller type AT89C2051. 
Admittedly, not a particularly excit- 
ing end product, but the assignment 
is not too complex and so forms a 
useful example for those that need to 
get to develop programming skills. 
Once the basics are mastered, the 
steps involved in writing code are 
easily applied to more serious appli- 
cations. 


Hardware 


To begin with, LEDs that form the 
‘face’ of the dice have to be con- 
nected to the microcontroller. Here, 
seven LEDs are used. As shown in 
Figure 1, they are connected to the 
seven connections of port P1. When 
high-efficiency LED are used, the 
value of the series resistors may be 
increased to 470 Q. As discussed in 
the Microcontroller Basics Course, 
LEDs are connected to Vcc via a cur- 
rent limiting resistor. The remaining 
port connection is used to monitor a 
pushbutton for activity. 

This experimental circuit is either 
fitted directly on the solder area of 
the 8988252 Flash board (December 
2001), or on a small dedicated (strip- 
) board and then connected to the 
Flash board using wires and con- 
nectors. 
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Listing |. Output bit pattern allocation 


microcontroller dice 


Pl.7 BISS 


7 

7 

7 

7 

Plo P1.4 P1.2 
7 

zoo giS TD e A 
7 

7 


P1.0 = key 


mov a,#00010001b 
mov Pl,a 
mov a,#01000101b 
mov Pl,a 
mov a,#01010101b 
mov Pl,a 
mov a,#01101101b 
mov Pl,a 
mov a,#11010111b 
mov Pl,a 
mov a,#11101111b 
mov Pl,a 


That’s all there is in the hardware 
department and we can now con- 
centrate on developing the software 
to roll the dice! 


Software development 


‘Assembler’ was chosen as the 
development tool because it is just 
right for this rather simple applica- 
tion. Moreover, a small program in 
assembler obviates the need for 
RAM, allowing the finished program 
to run happily on smaller controllers. 

The program is best developed in 
small steps. To begin with, we write 
the bit patterns for the driving of the 
LEDs. Here, clarity dictates the use 
of binary notation, allowing the allo- 
cation of the seven LEDs to the indi- 
vidual port connections to remain 
uncluttered. Each LED that’s on rep- 
resents a ‘0’. Bit 0, however, has to 
remain at ‘1’ because Port P1.0 is 
used as an input to read the push- 
button state (Listing 1). 

A wait loop is required to check 
the correct operation of the LED dri- 
ver, as well as for the final program. 
Here, a subroutine delay is 
employed to provide the necessary 
idle time. The amount of delay is 
transferred to the accumulator 
(Listing 2). 

In practice, the delay proved too 
short to enable our eyes to actually 


5/2002 Elektor Electronics 


output “6” 
youtput “5” 
output “4” 
output “3” 
soutput “2” 
FOutouE aL” 


see what the program is doing. Con- 
sequently, a second subroutine, 
delay2, was created, which waits 
slightly longer than a second. 
Delay2 calls delay several times 
(Listing 3) and should itself be called 
at a suitable pint in the main pro- 
gram. A small test program (List- 
ing 4) is now able to output all bit 
patterns (representing numbers on 
the dice) slowly and in sequence, 
allowing us to verify correct connec- 
tion of the hardware. Any errors in 
the previously defined bit patterns 
should be blatantly obvious now. 


Push to roll... 


The ‘roll’ pushbutton is scanned for 
activity in two loops. As longs the 
button is not pressed, the program 
should simply wait and idle away. 
The moment the pushbutton is 
pressed, the counter state that rep- 
resents the dice value should be 
automatically incremented. Here, 
register r1 is used to hold the 
counter state. However, r1 may only 
contain values 1 through 6 so we 
need to check if state ‘7’ is reached. If 
so, the counter has to be reset to 
state ‘1’. 

The decisive function of the pro- 
gram consists of assigning the indi- 
vidual bit patterns to the counter 
states. This is achieved with com- 


parisons and jump instructions. The instruc- 
tion cjne (compare and jump if not equal) 
does it all. In rapid succession, the contents 
of register r1 are compared to values 1 
through 6. If a match is found, the associated 
function is performed. A ‘non-equal’ outcome 
causes the program to branch to the next 
comparison. Using this allocation, a simple 
dice program may be written, as shown in 
Listing 5. 

In principle, we’ve completed the assign- 
ment. The die works! Each time the button 
is pressed, a rapidly changing readout is 
produced that stops at a number between 1 
and 6. 

Here, the program development was 
shown to consist of three steps. In practice, 
however, more than 20 steps were required. 
Each time, the source code text had to be 


Listing 2. Creating a delay 


delay mov r7,a 
delay0 mov r6,#255 
delayl djnz r6,delayl 


djnz r7,delay0 


ret 


Listing 3. Longer delay. 


main acall delay2 

out6 mov a,#00010001b 
mov Pl,a 

out5 acall delay2 
mov a,#01000101b 
mov Pl,a 

out4 acall delay2 
mov a,#01010101b 
mov Pl,a 

out3 acall delay2 
mov a,#01101101b 
mov Pl,a 

out2 acall delay2 
mov a,#11010111b 
mov Pl,a 

outl acall delay2 
mov a,#11101111b 
mov Pl,a 
sjmp main 





Listing 4. Successive dice patterns 


delay2 mov a, #255 
acall delay 
acall delay 
acall delay 
acall delay 
ret 
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changed, the program compiled and copied 
into the microcontroller. Why so many times? 

Well, because small errors will always 
creep in. The phased development of a pro- 
gram should result in a feeling best described 
as slowly crawling to your target. The 
8958252 Flash board considerably lightens 
this strategy of rapid prototyping. Using 
many small steps, trial and error will eventu- 
ally produce the desired result. Each time, 
testing a newly written part of the program 
requires only a few seconds. You may remem- 
ber them fondly and with nostalgia, but the 
times when EPROMs had to be erased and 
re-programmed to eliminate any small error 
are long gone. 


Practical tip 


The LEDs in the dice circuit you've built not 
only indicate the operation of the running pro- 
gram, but also the download process. That 
happens because the higher-value port con- 
nections P1.7, P1.6 and P1.5 are also involved 
in the processor programming process. The 
download tool uses a protocol on these lines to 
allow serial programming via the SPI inter- 
face. The pulses that occur during serial 
transfers become visible in the relevant LEDs. 
Very useful, actually, because it allows you to 
see if a download operation is in progress and 
successful. 

The rudimentary software does not, how- 
ever, provide feedback about the result, so 
that at least three errors may ‘bug’ you: 


1. Supply voltage not applied to Flash board. 


2. Communication ports COM1 and COM2 
ports interchanged. 


3. Communication port used is erroneously 
used by another program. 


The dice LEDs will faithfully indicate that 
everything is okay as far as the program 
download process is concerned. This ‘luxury’ 
is worthy of building into other projects as 
well. That’s why we propose to fit two LEDs 
with suitable series resistors in the prototyp- 
ing area of the Flash board. One indicates the 
presence of the supply voltage, the other any 
signals on P1.7. In this way, you always have 
a clear indication of what’s happening. 


Another tip 


After booting, Windows ME reportedly fails 
to clear the High on the DTR line of the PC’s 
serial ports. This may cause problems with 
the Flash board which is held in the rest 
state. 
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Listing 5. The first actually working dice. 


;dicel.asm 
microcontroller dice 
P1.7 P1.3 
P1.6 P1.4 P1.2 
PANS P1.1 


P1.0 = key 


, 
' 
, 
n 
' 
' 
' 
, 
r 
, 


#include 8051.H 


-org 0000H 
main mov a, #0FFh 
mov Pl,a yall leds off 
mov r1,#1 ;first number 
loop jb P1.0,loop ;wait for key 
key mov a,rl ;rl = memory 
inc a 


mov rl,a 
cjne r1,#7,out 
mov r1,#1 

out cjne r1,#6,out5 
mov a,#00010001b 
mov Pl,a 

out5 cjne r1,#5,out4 
mov a,#01000101b 
mov Pl,a 

out4 cjne r1,#4,out3 
mov a,#01010101b 
mov Pl,a 

out3 cjne r1,#3,out2 
mov a,#01101101b 
mov Pl,a 

out2 cjne r1,#2,outl 
mov a,#11010111b 
mov Pl,a 

outl cjne rl,#l,out0 
mov a,#11101111b 
mov Pl,a 


outdo jnb P1.0,key 
sjmp loop 
-end 


Listing 6. Improved program featuring slow-roll imitation. 


;dice2.asm 
microcontroller dice 
P1.7 BIL 3 
P1.6 P1.4 P1.2 
BISS BITI 


P1.0 = key 


, 
, 
' 
i 
i 
' 
' 
, 
' 
' 


#include 8051.H 
-org 0000H 
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main 


loop 
key 


play 


out 


out5 


out4 


out3 


out2 


outl 


outo 


delay 
delay1 
delay2 
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mov 
mov 
mov 
jb 
acall 
mov 
mov 
mov 
acall 
jnb 


acall 
mov 
acall 
acall 
mov 
acall 
acall 
mov 
acall 
acall 
mov 
acall 
acall 
mov 
acall 
acall 
mov 
acall 
acall 
mov 
acall 
acall 
mov 
acall 
acall 
acall 


sjmp 


mov 
ine 
mov 
cjne 
mov 
cjne 
mov 
mov 
cjne 
mov 
mov 
cjne 
mov 
mov 
cjne 
mov 
mov 
cjne 
mov 
mov 
cjne 
mov 
mov 
ret 


mov 
mov 
djnz 
djnz 
ret 


.end 


a, #0FFh 
Pl,a 
r1,#1 
P1.0,loop 
play 
a,#01h 
Pla 

a,#5 
delay 
P1.0,key 


play 
a, #150 
delay 
piay 
a, #200 
delay 
Pay 
a, #250 
delay 
pay 
a, #250 
delay 
delay 
piay 
loop 














arel 

a 

rl,a 
r1,#7,out 
r1,#1 
r1,#6,out5 
a,#00010001b 
Pl,a 
r1,#5,out4 
a,#01000101b 
Pla 
r1,#4,out3 
a,#01010101b 
Pla 
r1,#3,out2 
a,#01101101b 
Pl,a 
r1,#2,outl 
a,#11010111b 
Pl,a 
r1,#1,out0 
a,#11101111b 
Pl,a 


r7,a 
r6,#255 
r6,delay2 
r7,delayl 
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;all leds off 
¿first number 

;wait for key 
;rl=rit+rl 


;all leds on 


;roll 


¿slower 


¡slower 


¡slower 


; slower 


¡slower 


¡slower 


¿last 


¿stop 


;rl = memory 
;¿rl=r1+1 


;reset to 1 


output “6” 
poutput “5” 
output “4” 
output “3” 
output “2” 
Toutputi ai 


The solution to the problem is to either dis- 
connect the Flash board from the interface, or 
run the Flash download tool on the PC. The 
latter clears the DTR line to Low. 


Improvements 


As long as the dice runs on the Flash devel- 
opment board there’s room for improvements 
to the program. Real dice never stop as sud- 
den as our electronic equivalent, so one sug- 
gestion would be to mimic the ‘roll’ action 
slowing down gradually. Here, the effect is 
achieved by added software functionality. 
The dice are rolled in the routine play, while 
everything to do with waiting takes place in 
delay. When the button is released, the die 
‘rolls on’ for six more states, slowing down 
each time a new number is reached. A great 
improvement, we'd say, towards more realis- 
tic behaviour of our little circuit. 

While developing the program, it was 
noticed that the LEDs flicker somewhat 
unsteadily when the pushbutton is being 
pressed. This cosmetic problem was solved 
by making all seven LEDs light while the but- 
ton is pressed. 

Listing 6 shows the penultimate version 
of the program, ready for downloading to a 
small microcontroller system. By ‘penulti- 
mate’, we do not mean that there will be a 
follow-up article. Rather, you are encouraged 
to improve the program yourself, which will 
certainly present a challenge. 


Target system construction 


In order to transfer the functionality of the 
microcontroller dice to a standalone circuit, 
the hardware has to be defined. Well, besides 
the components already mentioned, not much 
more is required than a controller, a quartz 
crystal and a reset capacitor. Basically, that’s 
all you need to pencil down in the way of a 
circuit diagram. 

An important difference between the con- 
trollers we've in mind should be mentioned, 
however: port lines P1.0 and P1.1 of the 
AT89C2051 do not have internal pull-up 
resistors. The reason: they can be also be 
used as analogue comparator inputs. For 
LED control, that is not a problem. A push- 
button, however, does require an external 
pull-up resistor, which is not found in the 
development system. 

The program you have managed to 
develop is copied into the smaller microcon- 
troller using a suitable programmer. Next, 
everything is soldered together and tested. 

(021001-1) 
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